home *** CD-ROM | disk | FTP | other *** search
/ ASME's Mechanical Engine…ing Toolkit 1997 December / ASME's Mechanical Engineering Toolkit 1997 December.iso / intel / ppz8013a.lzh / A80Z.DOC < prev    next >
Text File  |  1987-03-15  |  38KB  |  1,101 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              PseudoSam 80z Assembler Manual V1.2.02
  12.                              Copyright(c) 1986,87 PseudoCode
  13.  
  14.  
  15.  
  16.  
  17.  
  18. Disclaimer:
  19.  
  20.             PseudoSam 80z is distributed as is, with no guarantee that it
  21.             will work correctly in all situations.  In no event will the
  22.             Author be liable for any damages, including lost profits,
  23.             lost savings or other incidental or consequential damages
  24.             arising out of the use of or inability to use these
  25.             programs, even if the Author has been advised of the
  26.             possibility of such damages, or for any claim by any other
  27.             party.
  28.  
  29.             It is the users reponsibility to back up all important files!
  30.  
  31.             See copyright information in appendix B
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                          Table of Contents
  38.  
  39. Chapter 1  PseudoSam 80z assembler vs. the Zilog assembler.
  40.  
  41. Chapter 2  Running the assembler program.
  42.  
  43. Chapter 3  Assembler statement syntax.
  44.  
  45. Chapter 4  Data types.
  46.  
  47. Chapter 5  Expressions.
  48.  
  49. Chapter 6  Assembler Directives.
  50.   (also known as assembler pseudo-opcodes, or pseudo-ops)
  51.  
  52. Appendix A      ASCII character set.
  53.  
  54. Appendix B      Copyright and registration information.
  55.  
  56. Appendix C      Description of Files.
  57.  
  58. Appendix D      Bug Reporting Procedure.
  59.  
  60. Appendix E      Using PseudoSam 80z on "Compatible" Systems.
  61.  
  62.  
  63.  
  64. Chapter 1 PseudoSam 80z assembler vs. the Zilog assembler
  65.  
  66.      All PseudoSam(Pseudo brand Symbolic AsseMbler) assemblers conform to
  67.      a common syntax based on the UNIX system V assembler syntax. By
  68.      conforming to this Pseudo standard, conflicts with the manufacturers
  69.      syntax are created.  Below is a brief and incomplete list of those
  70.      conflicts.
  71.  
  72.       Zilog format                        PseudoSam format
  73.  
  74. <identifier> equ <expression>         .equ <identifier> , <expression>
  75.  
  76. <identifier> set <expression>         .set <identifier> , <expression>
  77.  
  78. Has Macro capability                  No Macro capability at this time
  79.  
  80.  
  81.  
  82.  
  83. * The difference between the Zilog and the PseudoSam name
  84.   of an assembler directive can be circumvented by the .opdef
  85.   directive.
  86.  
  87.   example
  88.  
  89.    .opdef  eject,.eject      ;defines eject to be synonymous with .eject
  90.    .opdef  fcc,.db           ;fcc will now form constant characters as it
  91.                              ;should.
  92.  
  93. *  A file syn.asm is distributed with the assembler with some useful
  94.    redefinitions.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105. Unix system V is a trademark of AT & T.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113. Chapter 2  Running the assembler program
  114.  
  115. 1.  Command line switch setting and source file specification.
  116.  
  117.      Assuming the user has an assembly language source file called foo.asm
  118.      type the following command:
  119.  
  120. a80z foo
  121.  
  122.      The assembler will assemble the program foo.asm using the default
  123.      assembler switch settings. the following files will be generated
  124.      by the assembler:
  125.  
  126.      foo.lst   ;assembled listing shown the code conversion and
  127.                ; any errors that where discover by the assembler.
  128.  
  129.      foo.obj   ;assembled object code in Motorola Hex format.
  130.  
  131. **  for a list of switch setting see the .command assembler directive
  132.     description in chapter 6.
  133.  
  134. *** The assembler uses the following temporary file names.
  135.  
  136.     z0z0z0z0.tmp
  137.     z1z1z1z1.tmp
  138.  
  139.     ANY files with these names will be DESTROYED by the
  140.     by the assembler.
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148. Chapter 3  Assembler statement syntax
  149.  
  150. 1. Assembler Statements
  151.  
  152.      Assembler statements contain from zero to 4 fields as shown in
  153.      following.
  154.  
  155. <label> <opcode> <expressions> <comment>
  156.  
  157.      All fields are optional, but they must be in this order.
  158.  
  159. A.   Labels (<label>) are symbolic names that are assigned the starting
  160.      address of any code generated by the opcode and or expressions
  161.      of the line containing the label declaration.(see section 2).
  162.  
  163. B.   Operation codes(<opcode>) tell the assembler what machine instruction
  164.      to generate, or what assembler control function to perform.
  165.      The operation code also tells the assembler what expressions are
  166.      required to complete the machine instruction or assembler directive.
  167.      (see chapter 6).
  168.  
  169. C.   Expression requirements are set by the opcode(see the microprocessor
  170.      manufacturers reference manual or the assembler directives chapter
  171.      for individual opcode requirements).(see chapter 5).
  172.  
  173. D.   Comments are notes written by the programmer to explain what the
  174.      program is trying to accomplish. Comments generate no code.
  175.      (see section 3).
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183. 2.  Labels
  184.  
  185.      Labels can be unlimited in length, but only the first eight characters
  186.      are used to distinguish between them.  They must conform to the
  187.      following syntax.
  188.  
  189.      <label>  -> <identifier>':'
  190.  
  191.      <identifier> -> <alphabetic character> <identifier character string>
  192.  
  193.      <alphabetic character> -> character in the set ['A'..'Z', 'a'..'z', '.']
  194.  
  195.      <identifier character string> -> any sequence of characters from the
  196.                                       set ['A'..'Z','a'..'z', '.', '0'..'9']
  197.  
  198. example
  199. abc:                  ;label referred to as abc
  200. a c:                  ;not a valid label
  201.          foo:         ;label referred to as foo
  202. .123:                 ;label referred to as .123
  203.  
  204. * Case makes NO difference!
  205.  
  206. d:      ;is the same as
  207. D:
  208.  
  209.  
  210. 3.  Comments
  211.      Comments must start with a semi-colon ; and are terminated
  212.      by an end of line or file( <lf>(^J) or <sub>(^Z) ). An end
  213.      of line is inserted by typing the enter or return key by
  214.      most text editors.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. Chapter 4     Data types
  223.  
  224. 1.  Integers
  225.  
  226.     Integer constants can be specified in any of the following forms:
  227.  
  228. A.  Binary
  229.  
  230.     b'bb             ;bb=string of binary digits
  231.     B'bb
  232.  
  233. B.  Decimal
  234.  
  235.     ndd
  236.     d'dd             ;n=nozero decimal digit
  237.     D'dd             ;dd=string of decimal digits
  238.  
  239. C.  Octal
  240.  
  241.     0qq              ;qq=string of octal digits
  242.     o'qq
  243.     O'qq
  244.     q'qq
  245.     Q'qq
  246.  
  247. D.  Hexidecimal
  248.  
  249.     0x'hh            ;hh=string of hexidecimal digits
  250.     0X'hh
  251.     h'hh
  252.     H'hh
  253.     x'hh
  254.     X'hh
  255.  
  256.  
  257. Examples:
  258.  
  259.     077        ;octal number 77 = decimal 63
  260.     b'0101     ;binary number 101 = decimal 5
  261.     77         ;decimal number 77 = octal 115
  262.     h'ff       ;hexidecimal ff = decimal 255
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269. 2.  Strings:
  270.  
  271.     Strings consist of a beginning quote " followed by any reasonable number
  272.     of characters followed by an ending quote ". Control characters and double
  273.     quotes " and backslash \ may not be used in strings directly.  These
  274.     special characters are included by using a special escape sequence which
  275.     the assembler translates into the appropriate ASCII code.
  276.  
  277. Note: Strings may not be used in expressions!
  278.       Although character constants may(see below).
  279.  
  280. Escape sequences
  281.   "\"" string containing "
  282.   "\\" string containing \
  283.   "\'" string containing '
  284.   "\0" string containing null
  285.   "\n" string containing linefeed
  286.   "\r" string containing carriage return
  287.   "\f" string containing formfeed
  288.   "\t" string containing horizontal tab
  289.   "\nnn" string containing the ASCII character who's code is o'nnn
  290.          (nnn are octal digits).
  291.   * see appendix A for ASCII codes.
  292.  
  293. 3.  Character Constants:
  294.  
  295.     Character constants consist of  a single quote ' followed by
  296.     a character or an escape sequence(see above) followed by a
  297.     single quote '.
  298.  
  299. example:
  300.    'A' = ASCII character value for the letter A = 65 (decimal);
  301.    '\''= ASCII character value for the character ' = 39 (decimal).
  302.  
  303. Character constants are treated as integers by the assembler and
  304. are valid where ever an integer value is valid.
  305.  
  306. example:
  307.    'A' + 1 = 66
  308.  
  309.   * see appendix A for ASCII codes.
  310.  
  311. 4.  Symbolic values
  312.  
  313.     Symbolic values are generally labels, but may be any identifier
  314.     assigned an integer value(using .set or .equ pseudo-ops).
  315.  
  316.     As a special case the symbol * when used as an operand in an
  317.     expression denotes the value of the location counter (the value
  318.     the program counter will have during operation) at the beginning
  319.     of the current line.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326. Chapter 5  Expressions
  327.  
  328.      All expressions evaluate to integer values modulo 65536(2^16) and are
  329.      written in infix notation(the way you normally write them).  Operators
  330.      provided are grouped below in order of precedence.
  331.  
  332. 1. (unary)
  333. ~           logical bit wise complement(not) of its operand(one's complement).
  334. -           arithemetic complement, or negation(two's complement).
  335.  
  336. 2. (binary)
  337. *           integer multiply (two's complement).
  338. /           integer divide   (two's complement).
  339. %           modulus          (result is always positive)
  340. >>          logical shift right (left operand shifted right operand times).
  341. <<          logical shift left (left operand shifted right operand times).
  342. ~           equivalent to  A or ( ~B ).
  343.  
  344. 3. (binary)
  345. |           logical bitwise or(inclusive-or) of two operands.
  346. ^           logical bitwise exclusive-or of two operands.
  347. &           logical bitwise and of two operands.
  348.  
  349. 4. (binary)
  350. +           addition (two's complement).
  351. -           subtraction (two's complement).
  352.  
  353.      Since this version does not generate relocatable code there exists only
  354.      one "type" of operand that can be in an expression.  So anything goes
  355.      except divide by 0(1 will be substituted ).
  356.  
  357. examples:
  358.     -1 = h'ffff  (two's complement notation).
  359.     -1 >> 8 = h'00ff
  360.     -1 << 8 = h'ff00
  361.     3 / 2 = 1
  362.     6 / 2 = 3
  363.     5 / 0 = 5
  364.     -2 / 1 = -2
  365.     -3 /-2 = 1
  366.     2 * -3 = -6
  367.     b'00 & b'11 = 0
  368.     b'11 & b'10 = 2
  369.     2 * b'01 & b'10 = 2
  370.     b'01 ^ b'11 = 2
  371.     b'01 | b'11 = 3
  372.  
  373. Notice that spaces are ignored in expressions.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382. Chapter 6  Assembler Directives
  383.   (also known as assembler Pseudo-opcodes)
  384.  
  385.      The assembler recognizes the following directives:
  386.  
  387.       directive  section    description
  388.  
  389.       .command    1   ;set assembly options(similar to command line options).
  390.  
  391.       .org        2   ;set program origin.
  392.  
  393.       .equ        3   ;equate an identifier to an expression(permanent
  394.                       ; assignment).
  395.  
  396.       .set        4   ;equate and identifier to an expression(temporary
  397.                       ; assignment).
  398.  
  399.       .rs         5   ;reserve storage(memory) space.
  400.  
  401.       .db         6   ;define byte.
  402.  
  403.       .dw         7   ;define word(16 bit).
  404.  
  405.       .drw        8   ;define reversed word(16 bit).
  406.  
  407.       .eject      9   ;form feed in listing
  408.  
  409.       .page      10   ;align location counter on 256 byte memory
  410.                       ; page boundary.
  411.  
  412.       .end       11   ;end of program
  413.  
  414.       .opdef     12   ;equate an identifier with another identifier.
  415.  
  416.       .segment   13   ;define a memory segment.
  417.  
  418.       <segment name>
  419.                  14   ;select segment <segment name> as current segment.
  420.  
  421.       .null      15   ;this is a comment statement.
  422.  
  423.  
  424.  
  425.  
  426.  
  427. 1. .command    <optionlist>   ;allows the programmer to set option switches
  428.                               ;in the same manner as on the command line.
  429.                               ;(the command line is the line typed to run
  430.                               ; this program).
  431.  
  432. <optionlist> -> <option> ' ' <optionlist>
  433. <optionlist> ->
  434.  
  435. <option> -> '-'<available option>
  436. <option> -> '+'<available option>
  437.  
  438. <available option> -> 'a'<decimal number> ;Hex hode format.
  439.                                           ;1 => Intel Hex.
  440.                                           ;2 => Motorola 19 Hex.
  441.  
  442. <available option> -> 'w'<decimal number> ;page width in columns(characters).
  443.                                           ;(-,+ are ignored but one must be
  444.                                           ; there).
  445.  
  446. <available option> -> 'h'<decimal number> ;page height in lines.
  447.                                           ;(-,+ are ignored but one must be
  448.                                           ; there).
  449.  
  450. <available option> -> 'l'                 ;listing on(+) or off(-)
  451.                                           ;if set on command line it overrides
  452.                                           ;all listing controls in program.
  453.  
  454. <available option> -> 'm'<decimal number> ;Machine level.
  455.                                           ;1 => z80,nsc800.
  456.  
  457. <available option> -> 's'                 ;symbol listing on(+) or off(-).
  458.  
  459. <available option> -> 'o'                 ;selects single object module
  460.                                           ;file only(+), or multiple object
  461.                                           ;module files(-)(one for each
  462.                                           ;defined segment in the program).
  463.                                           ;ONLY active on command line!
  464.  
  465. <available option> -> 't'<drive>          ;specifies which drive to create
  466.                                           ;all temporary files on(-,+ are
  467.                                           ; ignored but one must be there).
  468.                                           ;ONLY active on command line!
  469.  
  470. <available option> -> 'p'<drive>          ;specifies which drive to create
  471.                                           ;the listing file on(-,+ are
  472.                                           ; ignored but one must be there).
  473.                                           ;ONLY active on command line!
  474.  
  475. <drive> -> <drive name>':'                ;e.g.  a:  b:  c:  d:
  476.  
  477.                            ;MS-DOS
  478. <drive name> -> 'a'        ;drive a --usually a floppy disk
  479. <drive name> -> 'b'        ;drive b --usually a second floppy disk
  480. <drive name> -> 'c'        ;drive c --usually a hard disk, but may
  481.                                       be a ram disk.
  482. <drive name> -> 'd'        ;drive d --usually a ram disk, but may
  483.                                       be a hard disk.
  484.  
  485. ** The default options are: -a2 -m1 -w132 -h66 +l +s +o
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493. 2. .org   <integer expression>    ;sets the assembler location counter
  494.                                   ;to the value of expression.
  495.                                   ;The expression MUST be evaluatable
  496.                                   ;on the first pass. NO FORWARD
  497.                                   ;REFERENCES!
  498.  
  499. 3. .equ  <identifier> ',' <integer expression>
  500.                                   ;gives identifier the value of the
  501.                                   ;integer expression.
  502.                                   ;<identifier> canNOT be redefined!
  503.                                   ;also forward references are allowed
  504.                                   ;as long as they are resolved by the
  505.                                   ;second pass.
  506.  
  507. 4. .set  <identifier> ',' <integer expression>
  508.                                   ;gives identifier the value of the
  509.                                   ;integer expression.
  510.                                   ;<identifier> CAN be redefined later
  511.                                   ; in the program!
  512.                                   ;also forward references are allowed
  513.                                   ;as long as they are resolved by the
  514.                                   ;second pass.
  515.  
  516. 5. .rs  <integer expression>      ;increments the location counter
  517.                                   ;by the value of <integer expresson>
  518.                                   ;effectively reserving that many bytes
  519.                                   ;of memory.
  520.  
  521. 6. .db  <expression-string list>
  522.  
  523. <expression-string list> -> <expression>','<expression-string list>
  524. <expression-string list> -> <string>','<expression-string list>
  525. <expression-string list> -> <expression>
  526. <expression-string list> -> <string>
  527.  
  528.                                   ;creates a byte in the machine code
  529.                                   ;for each <expression> in the list
  530.                                   ;and a byte for each ascii character
  531.                                   ;in the a string.
  532. 7. .dw  <expression list>
  533.  
  534. <expression list> -> <expression>','<expression list>
  535. <expression list> -> <expression>
  536.  
  537.                                   ;creates a word(16 bit) in the machine code
  538.                                   ;for each <expression> in the list.
  539.                                   ;MOST significant byte is stored at LOWER
  540.                                   ;address.
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547. 8. .drw  <expression list>
  548.  
  549. <expression list> -> <expression>','<expression list>
  550. <expression list> -> <expression>
  551.  
  552.                                   ;creates a word(16 bit) in the machine code
  553.                                   ;for each <expression> in the list.
  554.                                   ;LEAST significant byte is stored at LOWER
  555.                                   ;address.
  556.  
  557. 9. .eject                         ;causes a form-feed character to be
  558.                                   ;inserted in listing.(new listing page)
  559.  
  560. 10. .page                         ;increments location counter to next
  561.                                   ;256 byte page boundary.
  562.  
  563. 11. .end <integer expression>     ;signals the end of the source program.
  564.                                   ;the optional expression, if supplied,
  565.                                   ;specifies the start address of the
  566.                                   ;program, and is included in the
  567.                                   ;Motorola Hex object module output
  568.                                   ;of the active segment when the .end
  569.                                   ;was encountered.
  570.  
  571.  
  572. 12. .opdef  <identifier>,<identifier>
  573.                                   ;assigns the current definition of
  574.                                   ;the second <identifier> to the
  575.                                   ;first <identifier>.
  576.                                   ;useful for renaming opcodes and
  577.                                   ;pseudo-ops.
  578.  
  579. 13. .segment <identifier> ',' <integer expression>
  580.                                   ;defines a memory segment name.
  581.                                   ;used to separate memory allocation
  582.                                   ;and optionally generate seperate
  583.                                   ;object files.(see 'o' assembly
  584.                                   ;directive to activate).
  585.                                   ;(used to seperate RAM, ROM, or
  586.                                   ; ROMS)
  587.                                   ;the optional <integer expression> is
  588.                                   ;added to the location counter to
  589.                                   ;offset the load address supplied
  590.                                   ;in the object module. (does not
  591.                                   ;affect listings addresses!)
  592.                                   ;
  593.                                   ;note: .code is the predefined default
  594.                                   ;segment and cannot be redefined.
  595.  
  596. 14. <segment name>                ;selects the segment <segment name>
  597.                                   ;as the current memory segment.
  598.                                   ;The location old segment location counter
  599.                                   ;is saved and the previous value of the
  600.                                   ;newly selected segments location counter
  601.                                   ;is used(0 if not previously used).
  602.  
  603. 15.  .null                        ;directs the assembler to treat this
  604.                                   ;statement as a comment.  Useful to
  605.                                   ;nullify opcodes when used in conjunction
  606.                                   ;with the .opdef pseudo-op.
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614. Appendix   A      ASCII character set
  615.  
  616.  
  617.  
  618. dec oct hex char     dec oct hex char  dec oct hex char  dec oct hex char
  619.  
  620.   0 000  00 ^@ null   32 040  20 sp     64 100  40 @      96 140  60 `
  621.   1 001  01 ^A soh    33 041  21 !      65 101  41 A      97 141  61 a
  622.   2 002  02 ^B stx    34 042  22 "      66 102  42 B      98 142  62 b
  623.   3 003  03 ^C etx    35 043  23 #      67 103  43 C      99 143  63 c
  624.   4 004  04 ^D eot    36 044  24 $      68 104  44 D     100 144  64 d
  625.   5 005  05 ^E enq    37 045  25 %      69 105  45 E     101 145  65 e
  626.   6 006  06 ^F ack    38 046  26 &      70 106  46 F     102 146  66 f
  627.   7 007  07 ^G bel    39 047  27 '      71 107  47 G     103 147  67 g
  628.   8 010  08 ^H bs     40 050  28 (      72 110  48 H     104 150  68 h
  629.   9 011  09 ^I ht     41 051  29 )      73 111  49 I     105 151  69 i
  630.  10 012  0A ^J lf     42 052  2A *      74 112  4A J     106 152  6A j
  631.  11 013  0B ^K vt     43 053  2B +      75 113  4B K     107 153  6B k
  632.  12 014  0C ^L ff     44 054  2C ,      76 114  4C L     108 154  6C l
  633.  13 015  0D ^M cr     45 055  2D -      77 115  4D M     109 155  6D m
  634.  14 016  0E ^N so     46 056  2E .      78 116  4E N     110 156  6E n
  635.  15 017  0F ^O si     47 057  2F /      79 117  4F O     111 157  6F o
  636.  16 020  10 ^P dle    48 060  30 0      80 120  50 P     112 160  70 p
  637.  17 021  11 ^Q dc1    49 061  31 1      81 121  51 Q     113 161  71 q
  638.  18 022  12 ^R dc2    50 062  32 2      82 122  52 R     114 162  72 r
  639.  19 023  13 ^S dc3    51 063  33 3      83 123  53 S     115 163  73 s
  640.  20 024  14 ^T dc4    52 064  34 4      84 124  54 T     116 164  74 t
  641.  21 025  15 ^U nak    53 065  35 5      85 125  55 U     117 165  75 u
  642.  22 026  16 ^V syn    54 066  36 6      86 126  56 V     118 166  76 v
  643.  23 027  17 ^W etb    55 067  37 7      87 127  57 W     119 167  77 w
  644.  24 030  18 ^X can    56 070  38 8      88 130  58 X     120 170  78 x
  645.  25 031  19 ^Y em     57 071  39 9      89 131  59 Y     121 171  79 y
  646.  26 032  1A ^Z sub    58 072  3A :      90 132  5A Z     122 172  7A z
  647.  27 033  1B ^[ esc    59 073  3B ;      91 133  5B [     123 173  7B {
  648.  28 034  1C ^\ fs     60 074  3C <      92 134  5C \     124 174  7C |
  649.  29 035  1D ^] gs     61 075  3D =      93 135  5D ]     125 175  7D }
  650.  30 036  1E ^^ rs     62 076  3E >      94 136  5E ^     126 176  7E ~
  651.  31 037  1F ^_ us     63 077  3F ?      95 137  5F _     127 176  7F del
  652.  
  653.  ^ denotes control key simultaneous with character key.
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662. Appendix B       Copyright Information:
  663.  
  664.  
  665. Disclaimer:
  666.  
  667.             PseudoSam 80z is distributed as is, with no guarantee that it
  668.             will work correctly in all situations.  In no event will the
  669.             Author be liable for any damages, including lost profits,
  670.             lost savings or other incidental or consequential damages
  671.             arising out of the use of or inability to use these
  672.             programs, even if the Author has been advised of the
  673.             possibility of such damages, or for any claim by any other
  674.             party.
  675.  
  676. Copyright Information:
  677.  
  678.             The entire PseudoSam 80z distribution package, consisting of
  679.             the main program, documentation files, and various data and
  680.             utility files, is copyright (c) 1986, by PseudoCode.
  681.  
  682.             The author reserves the exclusive right to distribute this
  683.             package, or any part thereof, for profit.
  684.  
  685.             The name "PseudoSam (tm)", applied to an assembler
  686.             program, is a trade mark of the PseudoCode company.
  687.  
  688.             PseudoSam version 1.x.xx and various subsidiary files may be
  689.             copied freely by individuals for non-commercial purposes. It
  690.             is expected that those who find the package useful will
  691.             purchase the update service.
  692.             ONLY UNMODIFIED VERSIONS DISPLAYING THE AUTHORS COPYRIGHT
  693.             MAY BE COPIED.
  694.  
  695.             User groups and clubs are authorized to distribute PseudoSam
  696.             software under the following conditions:
  697.  
  698.             1.  No charge is made for the software or documentation.  A
  699.                 nominal distribution fee may be charged, provided that
  700.                 it is no more than $5 total.
  701.  
  702.             2.  Recipients are to be informed of the user-supported
  703.                 software concept, and encouraged to support it with
  704.                 their donations.
  705.  
  706.             3.  The program and documentation are not modified in ANY
  707.                 way, and are distributed together.
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.             Interested manufacturers please see the commercial registration
  715.             form that follows to license PseudoSam 18 for bundling with
  716.             MS-DOS based development systems.
  717.  
  718.             Distribution of PseudoSam 80z outside the United States is through
  719.             licensed distributors, on a royalty basis.  Interested
  720.             distributors are invited to contact PseudoCode.
  721.  
  722.  
  723.  
  724. Educational Use:
  725.  
  726.             Educational institutions are free to use this software
  727.             in their classes and are encouraged to distribute this
  728.             package to their students, however inorder to receive
  729.             periodic updates and technical assistance the appropriate
  730.             department must remit the license fee.  Also a staff
  731.             member must be assigned to clear all trouble reports before
  732.             forwarding them to PseudoCode.
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.         If you use this software, please help support it.  Your
  742.         support can take three forms:
  743.  
  744.         1. Become a registered user.  The suggested payment for
  745.            registration is $30($100 for complete family).
  746.  
  747.         2. Suggestions, comments, and bug reports.
  748.  
  749.         3. Spread the word.  Make copies for friends.  Write the editor
  750.            of your favorite computer magazine.  Astronomical advertising
  751.            costs are one big reason that commercial software is so over-
  752.            priced.  To continue offering PseudoSam 80z this way, we need
  753.            your help in letting other people know about PseudoSam 80z.
  754.  
  755.         Those who make the $30 payment to become registered users
  756.         receive the following benefits:(order form on next page)
  757.  
  758.         1. One year of updates including any upgrades. This includes
  759.            at least one new version release even if it takes more than
  760.            one year.
  761.  
  762.         2. User support by mail.  Support is only available to registered
  763.            users.  The address for help is given below.
  764.  
  765.         3. Notices announcing the release of new products.
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.              Attention:BUGS             PseudoCode
  776.                                         P.O. Box 1423
  777.                                         Newport News, VA     23601
  778.  
  779.  
  780.  
  781.  
  782.  
  783.       ********ORDER FORM********
  784.  
  785.       Please add me to the list of registered PseudoSam 80z users, and send me
  786.       the most recent version. I understand that registration entitles me to
  787.       one year of free updates and new releases, or one free new version
  788.       release, whichever occurs last.
  789.  
  790.       Note that version 1.2.02 requires DOS 2 (or later) and 256K.
  791.  
  792.       Computer Model: ____________________________________
  793.  
  794.       Diskette format:            Total Memory: _______K
  795.                                      (256K required)
  796.          __ doubled sided/DOS 2
  797.  
  798.       Check one:
  799.              ___ I enclose a check for $30
  800.              (PseudoCode pays sales tax for VA orders)
  801.  
  802.       Where did you hear about PseudoSam 80z? ________________________________
  803.  
  804.       Name:    _______________________________________________________
  805.  
  806.       Address: _______________________________________________________
  807.  
  808.       City, State, Zip: ______________________________________________
  809.  
  810.       ================================================================
  811.  
  812.            Send order form with check or money order payable to PseudoCode to:
  813.            (Qualified PO's will be billed.)
  814.  
  815.            Attention: Registration         PseudoCode
  816.                                            P.O. Box 1423
  817.                                            Newport News, VA     23601
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.       ********ORDER FORM********
  825.  
  826.       Please add me to the list of registered users of the complete
  827.       PseudoSam family of cross-assemblers. Send me the most recent
  828.       versions.  I understand that registration entitles me to
  829.       one year of free updates and new releases, or one free new
  830.       version release, whichever occurs last.
  831.  
  832.  
  833.       I note that version 1.2.02 requires DOS 2 (or later) and 256K.
  834.  
  835.       Computer Model: ____________________________________
  836.  
  837.       Diskette format:            Total Memory: _______K
  838.                                      (256K required)
  839.          __ single sided/DOS 2(360k)
  840.  
  841.       Check one:
  842.              ___ I enclose a check or money order for $100
  843.                  (shipping, handling, and Virginia sales tax for VA orders
  844.                   is paid by PseudoCode).
  845.  
  846.       Where did you hear about the PseudoSam family? ________________________
  847.  
  848.       Name:    _______________________________________________________
  849.  
  850.       Address: _______________________________________________________
  851.  
  852.       City, State, Zip: ______________________________________________
  853.  
  854.       ================================================================
  855.  
  856.            Send order form with check or money order payable to PseudoCode to:
  857.            (Qualified PO's will be billed.)
  858.  
  859.            Attention: Registration         PseudoCode
  860.                                            P.O. Box 1423
  861.                                            Newport News, VA     23601
  862.  
  863.  
  864.  
  865.  
  866.       ********Commercial Distribution Agreement********
  867.  
  868.       Please add me to the list of registered PseudoSam 80z distributors, and
  869.       send me the most recent version. I understand that registration entitles
  870.       me to distribute this package freely on an "as is" basis to purchasers
  871.       of my products. I further understand that I may not make a specific or
  872.       additional charge for this package. I may however advertise the package
  873.       as free software. I fully understand that the distributed software
  874.       must be clearly labeled as follows:
  875.  
  876.       Complementary Software
  877.       Distributed "AS IS"
  878.       PseudoCode
  879.       P.O. Box 1423
  880.       Newport News, VA 23601
  881.  
  882.  
  883.  
  884.       I understand that this agreement entitles me to one year of distribution
  885.       rights and free updates.
  886.  
  887.       Note that version 1.2.02 requires DOS 2 (or later) and 256K.
  888.  
  889.       Computer Model: ____________________________________
  890.  
  891.       Diskette format:            Total Memory: _______K
  892.                                      (256K required)
  893.          __ doubled sided/DOS 2
  894.  
  895.       Check one:
  896.              ___ I enclose a check for $30
  897.              (PseudoCode pays sales tax for VA orders)
  898.  
  899.       Where did you hear about PseudoSam 80z? ________________________________
  900.  
  901.       Name:    _______________________________________________________
  902.  
  903.       Address: _______________________________________________________
  904.  
  905.       City, State, Zip: ______________________________________________
  906.  
  907.       Signature_______________________   Date_________________
  908.  
  909.       ================================================================
  910.  
  911.            Send order form with check or money order payable to PseudoCode to:
  912.            (Qualified PO's will be billed.)
  913.  
  914.            Attention: Registration         PseudoCode
  915.                                            P.O. Box 1423
  916.                                            Newport News, VA     23601
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.       ********Commercial Distribution Agreement********
  924.  
  925.  
  926.       Please add me to the list of registered PseudoSam distributors, and
  927.       send me the most recent version. I understand that registration entitles
  928.       me to distribute this package freely on an "as is" basis to purchasers
  929.       of my products. I further understand that I may not make a specific or
  930.       additional charge for this package. I may however advertise the package
  931.       as free software. I fully understand that the distributed software
  932.       must be clearly labeled as follows:
  933.  
  934.       Complementary Software
  935.       Distributed "AS IS"
  936.       PseudoCode
  937.       P.O. Box 1423
  938.       Newport News, VA 23601
  939.  
  940.  
  941.  
  942.       I understand that this agreement entitles me to one year of distribution
  943.       rights and free updates for the entire PseudoSam family of products.
  944.  
  945.  
  946.       I note that version 1.2.02 requires DOS 2 (or later) and 256K.
  947.  
  948.       Computer Model: ____________________________________
  949.  
  950.       Diskette format:            Total Memory: _______K
  951.                                      (256K required)
  952.          __ single sided/DOS 2(360k)
  953.  
  954.       Check one:
  955.              ___ I enclose a check or money order for $100
  956.                  (shipping, handling, and Virginia sales tax for VA orders
  957.                   is paid by PseudoCode).
  958.  
  959.       Where did you hear about the PseudoSam family? ________________________
  960.  
  961.       Name:    _______________________________________________________
  962.  
  963.       Address: _______________________________________________________
  964.  
  965.       City, State, Zip: ______________________________________________
  966.  
  967.       Signature_______________________   Date_________________
  968.  
  969.       ================================================================
  970.  
  971.            Send order form with check or money order payable to PseudoCode to:
  972.            (Qualified PO's will be billed.)
  973.  
  974.            Attention: Registration         PseudoCode
  975.                                            P.O. Box 1423
  976.                                            Newport News, VA     23601
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.       The PsuedoSam Family consists of the following cross-assemblers
  985.  
  986.        Name            Designed for         Available*   V1.1.00
  987.  
  988.        PseudoSam 48   ;Intel 8048 family.     Now
  989.        PseudoSam 51   ;Intel 8051 family.     Now
  990.        PsuedoSam 96   ;Intel 8096 family.     Now
  991.        PseudoSam 68   ;Motorola
  992.                       ;6800,01,02,03,08.      Now
  993.        PseudoSam 685  ;Motorola 6805.         Now
  994.        PsuedoSam 69   ;Motorola 6809.         Now
  995.        PseudoSam 65   ;6502.                  Now
  996.        PseudoSam 85   ;Intel 8080,8085.       Now
  997.        PseudoSam 80z  ;Zilog Z80, NSC800.     Now
  998.        PseudoSam 18   ;RCA 1802.              Now
  999.        PseudoSam 32   ;NSC 32000 Family.      Apr 87
  1000.        PseudoSam 68k  ;Motorola 68000 family. May 87
  1001.  
  1002.    * PseudoCode reserves the right to change price and availability
  1003.      of any product without notice.
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013. Appendix C: Description of Files
  1014.  
  1015.       Your PseudoSam 80z distribution disk contains a number of files.  This
  1016.       appendix will give a brief statement of the purpose of each of the
  1017.       files.
  1018.  
  1019.       FILE           DESCRIPTION
  1020.       ----------------------------------------------------------------
  1021.       A80z.COM         The PseudoSam 80z program.
  1022.       A80z.DOC         This document.
  1023.       EXAMPLE.ASM     Sample source file.
  1024.       MNEMTEST.ASM    Mnemnonics test file.
  1025.       SYN.ASM         Useful mnemnonics redefinitions
  1026.       COMRCIAL.USE    Commercial distribution agreement.
  1027.  
  1028.       Occasionally, various other sample source files for PseudoSam 80z will be
  1029.       distributed.  These files will have extension ASM, and will be
  1030.       accompanied by a corresponding DOC file.
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040. Appendix D: Bug Reporting Procedure.
  1041.  
  1042.  
  1043.       Although each version of PseudoSam 80z is tested extensively prior
  1044.       to release, any program is bound to contain a few bugs.  It is
  1045.       the intention of PseudoCode to correct any genuine problem that
  1046.       is reported.
  1047.  
  1048.       If you think you have found a bug in PseudoSam 80z, please take the time
  1049.       to report it for correction.  Although any report is helpful,
  1050.       correction of the problem will be easiest if you provide the
  1051.       following:
  1052.  
  1053.          1. The version of PseudoSam 80z you are using.  Your problem may have
  1054.             been fixed already.
  1055.  
  1056.          2. A brief description of the problem.
  1057.  
  1058.          3. A copy of the problem source file, preferably on a floppy disk.
  1059.             (The cost of floppies is so small($.29), they will not be
  1060.              returned and become the property of PseudoCode.)
  1061.  
  1062.             * It is NOT necessary to send a large program to demonstrate
  1063.               problem.  Please try to isolate the problem area, by
  1064.               writing a short sample program that demonstrates the bug.
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.              Attention:BUGS             PseudoCode
  1072.                                         P.O. Box 1423
  1073.                                         Newport News, VA     23601
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.       Appendix E   Using PseudoSam 80z on "Compatible" Systems.
  1082.  
  1083.       PseudoSam 80z was written specifically for the IBM PC, but should
  1084.       function normally on true "compatibles".
  1085.  
  1086.       Since PseudoSam 80z version 1.2.00 is a totally new program, little
  1087.       compatibility data is currently available.  If you are using (or
  1088.       are unable to use...) PseudoSam 80z on a non-IBM computer, please
  1089.       write with your experiences.  Does PseudoSam 80z work correctly on
  1090.       your system?  Are there specific problem areas?  Can they be worked
  1091.       around?
  1092.  
  1093.       The following systems are known to run PseudoSam 80z version 1.2.00
  1094.       successfully:
  1095.              IBM PC
  1096.              IBM XT
  1097.              IBM AT
  1098.              Sperry PC (all models).
  1099.              JDR Microdevices PC Clones.
  1100.  
  1101.